home *** CD-ROM | disk | FTP | other *** search
/ Freelog 22 / freelog 22.iso / Prog / Djgpp / RHIDE14B.ZIP / doc / rhide / readme.key < prev    next >
Encoding:
Text File  |  1997-10-01  |  3.9 KB  |  106 lines
  1. If you have problems with some keys in RHIDE, it is probably
  2. because you have an other keyboard layout than the US standard
  3. keyboard. In that case try at first to run RHIDE with the
  4. '-k ...' switch, where '...' stands for the shortcut of
  5. your country. (for instance in germany try '-k de').
  6.  
  7. If you are running RHIDE on linux, it is the best to use
  8. exact the same name, like your loaded keyboard table, since
  9. the config files here are derived from them.
  10.  
  11. If that doesn't solve the problem, try any other of the
  12. files in $(prefix)/share/rhide which ends in '.txt' by
  13.  
  14. (but NOT 'pmacros.txt' or 'syntaxhl.txt', which is an totaly
  15. different config file)
  16.  
  17. giving after the '-k' only the part before '.txt'. 
  18. If you found any working file, copy it to 'keybind.txt'
  19. and RHIDE will use it from now on as default.
  20.  
  21. If all of the above doesn't help you, read below:
  22.  
  23.    Instructions to create a new keyboard config file:
  24.  
  25.    1) Create 'gkey.exe', which is in the tvision subdirectory
  26.       either with RHIDE using the .gpr file or type there
  27.  
  28. make -f gkey.mak
  29.  
  30.    2) Read the 'keybind.cc' file, this file contains ALL the keyboard
  31. assigments for the commands of the editor.
  32.  
  33.    3) Search any difference between the commands and your keyboard. For
  34. example: the german keyboards don't do ^Y like we spect, that's the line
  35. isn't deleted, instead the editor is scrolled. Put all the annoying diffs.
  36. in a paper or file.
  37.  
  38.    4) Read the 'keybind.h' and 'keybind.cc' to find what scan code have the
  39. differenece, for example (I'll continue with the german example):
  40. In 'keybind.cc' says:
  41.  
  42. [CONTROL]
  43. .
  44. . [snipped lines]
  45. .
  46. Y         = cmbDelLine
  47. ...
  48.  
  49.   That means Control+Y will triggers the cmbDelLine command (a description of
  50. all the commands is in 'editor.inf').
  51.   Searching in 'keybind.h' you'll find:
  52.  
  53. #define Y           21
  54.  
  55.   So the editor spects a 21 value of scan code for the Y key.
  56.   Take notes of all the scan codes that generate problems based on your
  57. first list.
  58.  
  59.   Until now we have: ^Y doesn't work, the editor wants 21 for Y.
  60.  
  61.   5) Run gkey and press the problematic keys to find the scans reported for
  62. your keyboard, in our example:
  63.  
  64. Pressing ^Y the german people gets (the dots stand for other
  65. information):
  66.  ... ScanCode: 44 ...
  67.  
  68.  The difference is in the scan 44 v.s. 21, the ascii is correct in this case.
  69. So you must correct the #define in the keybind.h to reflect this situation,
  70. but don't do that in the keybind.h file, make the corrections in the file
  71. named 'my.h', rename this file to the internet domain of your country, in
  72. our example is Germany == de, so you must rename the file to 'de.h', then
  73. modify the keybind.h file to load the de.h file, there are an explanation
  74. of that in the keybind.h file.
  75.  
  76.   That's the half of the work because the scan 44 is mapped to other key in
  77. keybind.h, there are two ways to know what's the key:
  78.  
  79. 1) I'm sure that you can detect pairs of problems like that, in the german
  80. keyboards the ^Z will delete the line, pressing ^Z in gkey the german people
  81. gets: Scancode: 21, that's logic because these keyboards have the
  82. Z and the Y swapped!
  83. 2) Search in the keybind.h what key have the 44 assigned, you'll get Z.
  84.  
  85.   With this info. you can correct the #define for Z.
  86.  
  87.   6) With all or any of the problems fixed you must test if that's works, for
  88. this purpose you must create 'keybind.txt', use:
  89.  
  90.    cpp keybind.cc > keybind.txt
  91.  
  92.    Now copy the keybind.txt file to the %DJDIR%/share/rhide directory, if you
  93.    don't have this directory create it. For testing first, you can rename it
  94.    to test.txt and run RHDIDE with the '-k test' switch to use the file
  95.    'test.txt' as keyboard definition file.
  96.  
  97.   7) When you get all working send me the xx.h file to:
  98.  
  99.   salvador@inti.edu.ar
  100. and
  101.   robert.hoehne@mathematik.tu-chemnitz.de
  102.  
  103.   and I'll include the file in the package.
  104.  
  105. Good luck and thank you.
  106.